home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / rnd10.zip / RND.DOC < prev   
Text File  |  1991-12-02  |  6KB  |  111 lines
  1.  
  2.                                    RND.DOC
  3.                                    -------
  4.                            Instructions for RND.COM
  5.                            Version 1.0 (7 Oct 1991)
  6.  
  7.                                (c)1991 E. Meyer
  8.  
  9.  
  10.      RND allows you to rename and move directories, which is much easier than 
  11. the methods required by DOS commands: making a new directory, copying all its 
  12. contents, then deleting the original one.
  13.      Several other free or shareware utilities for this purpose exist, but 
  14. some are large and inefficient (RND is just 2k), some use awkward input 
  15. conventions, some can only rename, most can't move to another drive, and none 
  16. seem to handle changes to the current directory on a drive correctly.
  17.      A good directory and tree display utility, such as my own DTA (dir/tree/ 
  18. attrib), will be a useful aid in your use of RND.  Experiment with both a 
  19. little to be sure you understand how RND works.
  20.  
  21.  
  22. SYNTAX:        A>rnd {d:}{path}dirname {d:}{path}newname       "{}"=optional
  23.  
  24.  
  25.      Wildcards (?,*) may not be used.  Neither argument can be the root 
  26. directory, "\".  The first must be an existing subdirectory, and the second a 
  27. valid subdirectory name that does not yet exist.
  28.      If the first drive or path is not specified, the current defaults are 
  29. assumed.  (You can use "." alone to indicate the current directory on a 
  30. drive.)  If a new drive or path is not specified, it remains the same as the 
  31. first, and the directory is simply RENAMED.  If the new path is different, 
  32. then the tree is reorganized so that the directory (with all subdirectories) 
  33. is MOVED to a different parent directory.  (You can rename and move at the 
  34. same time; see examples below.)  In either case the process is very fast, 
  35. involving only rearrangement of directory information.  Only if the new drive 
  36. is different will all the files in the directories actually have to be COPIED 
  37. and then DELETED, which takes longer; but this is seldom done.
  38.      If you type "RND" alone (or with the option "/?") you will get a brief 
  39. help message.
  40.  
  41.  
  42.                               EXAMPLES: RENAMING
  43.  
  44.   A:\WORK>rnd c:\wp writing  Renames dir C:\WP       --> C:\WRITING
  45.   A:\WORK>rnd sue susan      Renames dir A:\WORK\SUE --> A:\WORK\SUSAN
  46.   A:\WORK>rnd . current      Renames dir A:\WORK     --> A:\CURRENT
  47.  
  48.  
  49.                                EXAMPLES: MOVING
  50.  
  51.   A:\WORK>rnd sue c:\temp\sue     Moves dir A:\WORK\SUE   --> C:\TEMP\SUE
  52.   A:\WORK>rnd sue \susan          Moves dir A:\WORK\SUE   --> A:\SUSAN
  53.   A:\WORK>rnd \wp \urgent\wp      Moves dir A:\WP         --> A:\URGENT\WP
  54.   A:\WORK>rnd \wp \wp\bill        Moves dir A:\WP         --> A:\WP\BILL
  55.  
  56.      These call for further comment.  The first example moves the SUE 
  57. subdirectory (and all its contents, including subdirectories) out of the 
  58. A:\WORK directory into the C:\TEMP directory (which will be created if it did 
  59. not already exist).
  60.        A:\              C:\                 A:\            C:\
  61.           \work                    -->         \work          \temp   
  62.                \SUE                                                \SUE
  63.                    \...                                                \...
  64.      The second example renames SUE to SUSAN and moves it up the directory 
  65. tree on drive A, from a subdirectory of A:\WORK to one of the root A:\.
  66.                  A:\                        A:\    
  67.                     \work          -->         \work
  68.                          \SUE                  \SUSAN
  69.                              \...                    \...
  70.      The third example moves WP down the directory tree, from a subdirectory 
  71. of A:\ to one of A:\URGENT (which will be created if necessary).
  72.                  A:\                        A:\
  73.                     \work          -->         \work
  74.                     \WP                        \urgent
  75.                        \...                           \WP
  76.                                                          \...
  77.      The fourth example is potentially confusing.  It too moves WP one level 
  78. down the tree; this time it also renames it to BILL, while making it a 
  79. subdirectory of a directory (otherwise empty) called \WP.
  80.                  A:\                        A:\
  81.                     \work          -->         \work
  82.                     \WP                        \wp
  83.                        \...                       \BILL
  84.                                                        \...
  85.  
  86.  
  87.                                     ERRORS
  88.  
  89.      RND works on all MSDOS systems (2.x and above) and networks; it uses no 
  90. low level disk access, just standard DOS calls.
  91.      When moving directories, there must be enough free space on the disk to 
  92. create the new directory tree (and, if moving to another drive, to copy all 
  93. the files contained).
  94.      In a batch file, the DOS ERRORLEVEL can be tested: RND returns 1 for a 
  95. bad argument, 2 for an invalid or existing directory name, 4 if it runs out of 
  96. memory, and 8 for an error encountered while attempting to move a directory 
  97. (including full disk).
  98.  
  99.  
  100.  
  101.      RND and its documentation are (c)1991 Eric Meyer, all rights reserved.  
  102. They may be freely distributed, but not modified or sold for profit without my 
  103. written consent.  (Exception: Libraries may charge up to $6 for a disk.)  The 
  104. user takes full responsibility for any damages resulting from the use of this 
  105. program.
  106.  
  107.                  Eric Meyer
  108.               3541 Smuggler Way              CompuServe [74415,1305]
  109.            Boulder, CO  80303  USA
  110.  
  111.